Zen

Source string Source string

52/10000 · 52

The string is read only.

English Actions
Quick Start Guide
Are you eager to try out how the Fedora CI tests work? Do you want to get a quick hands-on experience without having to read too much documentation? This quick introduction for the impatient will show you a minimal set of steps to execute existing tests as well as provide useful links to resources where you can learn more.
First Steps
Install the following essential packages on your system (consider using a virtual machine for safe experimenting):
sudo dnf install fedpkg standard-test-roles
Use `fedpkg` to clone the package git repository. See the https://docs.fedoraproject.org/en-US/package-maintainers/Package_Maintenance_Guide/[Package Maintenance Guide] for more info about the tool.
fedpkg clone -a bash
git checkout -b f33 remotes/origin/f33
Tests are defined according to the xref:standard-test-interface.adoc[Standard Test Interface] in the `tests` directory:
cd bash/tests/
Test coverage to be executed together with the basic set of metadata is described in the https://src.fedoraproject.org/rpms/bash/blob/rawhide/f/tests/tests.yml[tests.yml] playbook. Use `ansible-playbook` to run all available tests for the classic environment on the local host (needs to be run as root):
ansible-playbook --tags=classic tests.yml
From the ansible output you can directly see an overall summary of the testing. If you see `failed=0` at the end of the log then all tests passed:
localhost: ok=29 changed=11 unreachable=0 failed=0
For more detailed test results check the `test.log` and other files in the `artifacts` directory:
vim artifacts/test.log
That's it! You just executed test coverage for the Bash package :)
Test Subjects
To execute tests against different test subjects we need to prepare the environment. Let's store the detailed test results in `/tmp/artifacts`, use dynamic inventory as defined by the xref:standard-test-roles.adoc[Standard Test Roles] and download the latest Atomic Host image.
export TEST_ARTIFACTS=/tmp/artifacts
export ANSIBLE_INVENTORY=/usr/share/ansible/inventory
curl -Lo /tmp/atomic.qcow2 https://getfedora.org/atomic_qcow2_latest
Now let's try to run tests against all supported test subjects.
Classic
Run tests against classic rpms installed on the system:
export TEST_SUBJECTS=''
ansible-playbook --tags=classic tests.yml
See xref:standard-test-roles.adoc#_classic[Classic] for detailed docs.
Container
For testing containers there is an additional dependency needed:
sudo dnf install standard-test-roles-inventory-docker
Run tests in a docker container:

Loading…

User avatar None

Source string added

  1. fedora-docs-l10n/ci
  2. master/pages/quick-start-guide
  3. English
localhost: ok=29 changed=11 unreachable=0 failed=0
4 years ago
Browse all string changes

Things to check

Multiple failing checks

Following checks are failing:
Punctuation spacing: French, French

Reset

Glossary

English English
No related strings found in the glossary.

String information

Source string description
type: Plain text
Flags
no-wrap, read-only
Source string location
./pages/quick-start-guide.adoc:33
String age
4 years ago
Last updated
11 months ago
Source string age
4 years ago
Translation file
pot/master/pages/quick-start-guide.pot, string 13